docs: add Dokploy self-hosting guide#3082
Merged
Merged
Conversation
Adds a Dokploy platform page under self-hosting, mirroring the Coolify guide (installation, configuration, troubleshooting) plus Dokploy-specific sections on domains/HTTPS and wildcard certificates for site and function subdomains. Includes a light/dark screenshot of the deployed Appwrite services, and links the new page from the self-hosting overview and sidebar.
Appwrite WebsiteProject ID: Website (appwrite/website)Project ID: Tip Trigger functions via HTTP, SDKs, events, webhooks, or scheduled cron jobs |
Contributor
Greptile SummaryThis PR adds a new Dokploy self-hosting guide under the existing platforms section and fixes two correctness issues in the Coolify guide that were flagged in prior reviews.
Confidence Score: 5/5Documentation-only change with no runtime code; all previously flagged issues have been addressed. The change is purely additive documentation. Previously reported issues (wrong No files require special attention. Important Files Changed
Reviews (7): Last reviewed commit: "(fix): correct GitHub VCS integration de..." | Re-trigger Greptile |
Member
Author
|
Rendered docs page (dark + light) — /docs/advanced/self-hosting/platforms/dokploy
|
Regenerate the deployed-service screenshots through the repo image optimizer (bun run optimize) so both avif files have entries in .optimize-cache.json, matching every other docs image. Addresses Greptile review.
![greptile-apps[bot]](https://avatars.githubusercontent.com/in/867647?s=60&v=4){kind=small}
The _APP_VCS_GITHUB_* variables configure a GitHub App for deploying functions and sites from repositories (VCS integration), not console OAuth login. Corrects the misleading description. Addresses Greptile review.
The HTTPS section conflated single-host and wildcard domains. Now: main domains use Let's Encrypt; wildcard domains require a DNS-01-issued cert uploaded to Settings > Certificates AND their certificate provider set to None (the commonly-missed step, otherwise Traefik retries an impossible wildcard issuance). Adds a Cloudflare callout covering the second-level-wildcard edge-cert limitation and why Origin certs don't work.
_APP_SMTP_SECURE takes tls, ssl, or empty — not a boolean. Fixes the Dokploy guide and the pre-existing same error in the Coolify guide. Addresses Greptile review.
Documents the simpler workaround for HTTPS on specific site/function domains: add the exact (non-wildcard) domain in the Domains tab with Let's Encrypt, and Dokploy issues a standard HTTP-01 certificate for it. Notes the trade-off vs the wildcard certificate approach.
Same fix as the Dokploy guide: _APP_VCS_GITHUB_* configure a GitHub App for deploying functions/sites from repositories (VCS integration), not console OAuth login.
HarshMN2345
approved these changes
Jul 4, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Adds a Dokploy platform guide under Self-hosting, alongside the existing Coolify page. Dokploy ships Appwrite as a one-click template, so this documents deploying and configuring it.
Changes
docs/advanced/self-hosting/platforms/dokploy— installation, domains & HTTPS, configuration (Assistant/SMS/SMTP/GitHub), and troubleshooting, following the structure of the Coolify guide.Testing